Summary

• Add a native home screen widget that displays the daily puzzle with a rendered board image, side to move, and play count
• Implement HomeWidgetService in Flutter that listens for daily puzzle updates and board preference changes, then pushes
  data to the native widget via the home_widget package
• iOS widget uses WidgetKit with SwiftUI, supporting both .systemSmall and .systemMedium families; Android widget uses
  Jetpack Glance with Compose
• Tapping the widget opens the app (and navigates to the puzzle via deep link on iOS)

Implementation Details

Flutter (Dart)

• New HomeWidgetService (lib/src/model/home_widget/home_widget_service.dart) started in app.dart alongside other services
• Listens to dailyPuzzleProvider and boardPreferencesProvider to keep the widget in sync
• Renders the chessboard as a static image using StaticChessboard from the chessground package
• Uses App Group (group.org.lichess.mobileV2) for shared data storage between the app and widget extensions

Android

• DailyPuzzleWidget built with Jetpack Glance (androidx.glance:glance-appwidget:1.1.1)
• DailyPuzzleWidgetReceiver extends HomeWidgetGlanceWidgetReceiver
• Widget auto-updates every 24 hours (updatePeriodMillis: 86400000)
• Added Kotlin Compose compiler plugin for Glance support

iOS

• DailyPuzzleWidget WidgetKit extension with TimelineProvider
• Supports systemSmall (board + side to move) and systemMedium (board + side to move + play count + CTA) sizes
• Timeline refreshes hourly
• Configured with shared App Group entitlements for both Runner and widget extension

Dependencies

• Added home_widget: ^0.9.0 to pubspec.yaml

Test plan

• Verify the widget appears in the home screen widget picker on both iOS and Android
• Confirm the board image renders correctly with the user's board theme and piece set
• Change board preferences (theme, piece set) in the app and verify the widget updates
• Test the widget displays "Open Lichess to load" when no puzzle data is available yet
• Verify tapping the widget opens the app
• Test on iOS with both .systemSmall and .systemMedium widget sizes
• Verify the widget updates when a new daily puzzle is available